home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / rad213.zip / RADPLUS.DOC < prev    next >
Text File  |  1992-10-19  |  22KB  |  537 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.           :::::::::::::::        :::::::::::::      ::::::::::::::
  22.           ::::::::::::::::      :::::::::::::::     ::::::::::::::::
  23.           :::::       :::::    :::::       :::::    :::::      ::::::
  24.           :::::       :::::    :::::       :::::    :::::       :::::
  25.           ::::::::::::::::     :::::::::::::::::    :::::       :::::
  26.           :::::::::::::::      :::::::::::::::::    :::::       :::::
  27.           :::::    :::::       :::::       :::::    :::::       :::::
  28.           :::::     :::::      :::::       :::::    :::::      ::::::
  29.           :::::      :::::     :::::       :::::    ::::::::::::::::
  30.           :::::       :::::    :::::       :::::    ::::::::::::::   Plus
  31.  
  32.  
  33.                           Remote Access Database v2.12
  34.  
  35.                      (dBASE III & dBASE III Plus Compatible)
  36.  
  37.                          Copyright (C) 1990 Overerx Inc.
  38.                             Kingston, Ontario, Canada
  39.                        Harvey Parisien * FidoNet 1:249/114
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                                                RAD Plus - Remote Access Database
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.                            Background / What is RAD?
  72.  
  73.  
  74.  
  75.          RAD v1.00 series has been around for a while now.  It is a
  76.          simple online database system with it's own dedicated file
  77.          structure.  It is simple to operate, and serves a purpose.
  78.          Primarily it is directed towards BBS use.  It is available on
  79.          a shareware basis and distributed via SDS (Software
  80.          Distribution System).
  81.  
  82.          RAD Plus v2.00 series is the commercial version which is in
  83.          dBASE III format file structure for optimum flexibility and
  84.          compatibility with current and future environments.  It tends
  85.          to simulate standard dBASE<tm> type commands, which are
  86.          familiar to dBASE users.  It is also offered on a shareware
  87.          basis and distributed via SDS.
  88.  
  89.          This document will deal only with RAD Plus, but will simply
  90.          make reference to the name RAD to save key strokes.
  91.  
  92.          We will refer to the RAD Operator, and the RAD User.  The RAD
  93.          Operator is the System Operator (SysOp) or the System
  94.          Administrator whatever the case may be.  The RAD User is the
  95.          remote caller.
  96.  
  97.          RAD is designed with many considerations to offer maximum
  98.          security to the BBS SysOp, and in non-bbs (less secure)
  99.          environments.  However, the concern for security does not
  100.          make remote maintenance difficult for the RAD Operator.  All
  101.          maintenance can be performed remotely with the correct
  102.          security level.  For non-bbs type setups, you may request
  103.          from the author a Host/Terminal system which will allow
  104.          control of your computer remotely (including file transfers),
  105.          and can be used to answer the phone for RAD, clear passwords,
  106.          and so on (it will create a dorinfo1.def exit file - more on
  107.          that later).  HTERM is a nice terminal for the remote user as
  108.          well, written by the author of RAD.  It is available as
  109.          freeware on most BBS systems, or request HTERM from the
  110.          FidoNet address stated below.
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                                                                           Page 1
  121.                                                RAD Plus - Remote Access Database
  122.  
  123.                          Files required to setup RAD...
  124.  
  125. RAD comes in an archived format.  We use LHA as our standard, but some BBS's or
  126. distribution systems may convert the archive structure.  The archive name is
  127. usually RAD???.LZH where ??? is the version number.  IE:  RAD209.LZH is the
  128. archive for version 2.09.
  129.  
  130. The files in RAD???.LZH are:
  131.  
  132.     DB.EXE       A dBASE III file editor (used for setup).
  133.     DB.DOC       Documentation for above.
  134.   * RADPLUS.EXE  RAD the program.
  135.     RADPLUS.DOC  This document.
  136.   * RADCFG.DBF   RAD's main configuration file.
  137.   * RADDIR.DBF   RAD's file directory/file subject file.
  138.  
  139.                  * = required for RAD to operate.
  140.  
  141.     ARTICLES DBF   Sample database...
  142.     BOOKS    DBF   Sample database...
  143.     SERVICES DBF   Sample database...
  144.     SUPPORT  DBF   Sample database...
  145.  
  146.     INFO.TXT   Some general information text files...
  147.     RAD2??.SDA Some general information text files...
  148.  
  149.     REGISTER.TXT   An application for to register RAD.
  150.  
  151.     DORINFO1 DEF   Sample exit file (created by BBS or other answering devices)
  152.  
  153. The only files required to run RAD are the ones marked with a *.  Your security
  154. levels and modem information etc. are contained in RADCFG.DBF and RADDIR.DBF.
  155. Let's look at each file and discuss them in detail.  Use DB.EXE to edit both
  156. RADDIR.DBF and RADCFG.DBF for your initial setup.
  157.  
  158.  
  159.                                    RADCFG.DBF
  160.  
  161. Record:  1  of  1
  162.  
  163. SYSOP_NAME :Harvey Parisien                    :
  164. SYSTEMNAME :The Lighthouse BBS                      :
  165. SCREEN_LEN :25                          :
  166. LEVEL1     :    5:
  167. LEVEL2     :   20:
  168. LEVEL3     :   40:
  169. LEVEL4     :  100:
  170. USAGE_LOG  :                                        :
  171. DOOR_INFO  :dorinfo1.def                            :
  172. MIN_TIME   :     5:
  173. MAX_TIME   :   120:
  174. COM_PORT   :COM1:
  175. MAX_BAUD   :2400  :  (NOTE: by an L in this field, it will lock the baud rate
  176. USE_SCREEN :T:              ie: 19200L )
  177.  
  178. SYSOP_NAME is the name of the System Operator (can be a department or company
  179.  
  180.                                                                           Page 2
  181.                                                RAD Plus - Remote Access Database
  182.  
  183. name also), and SYSTEMNAME is the BBS name (can be just an internal system name
  184. of any sort).  The next field is where you can set the screen length of your
  185. callers terminal system.  Most terminals require this to be a maximum of 25.
  186. Level1 through to level4 are basically translation tables to translate your
  187. numeric security levels from your BBS, to RAD's 4 basic user levels.  In the
  188. scenario above, in order to have level 3 access, your BBS access level must be
  189. at least 40 or greater.
  190.  
  191. If you would like RAD to keep a usage log for you, enter a complete drive spec
  192. and path for your log file.  The log will record logons, and database changes,
  193. and each applicable record number.  Here's an example...
  194.  
  195. + 29 Sep 21:09:25 BINK end, Binkley 2.40
  196. + 01 Oct 19:21:00 MAX  Begin, v2.00
  197. + 01 Oct 19:21:01 MAX  Harvey Parisien calling (U#=0)
  198. # 01 Oct 19:21:02 MAX  Given 10000 min.
  199. # 01 Oct 19:21:10 MAX  External program: `C:\bc7\bin\radplus.exe /pC:\max\rad'
  200. + 01 Oct 19:21:11 RAD  Begin, v2.09 (user='HARVEY PARISIEN')
  201. + 01 Oct 19:21:11 RAD  File write: SUPPORT.DBF # 59
  202. + 01 Oct 19:21:11 RAD  End, v2.09
  203. : 01 Oct 19:21:31 MAX  Return from: `C:\bc7\bin\radplus.exe /pC:\max\rad' (0)
  204. + 01 Oct 19:21:34 MAX  Harvey Parisien off-line. Calls=429, Len=0, Today=0
  205. : 01 Oct 19:21:35 MAX  End, v2.00 (5)
  206.  
  207. As you can see, RAD has a log format compatible with Binkley, and/or Maximus.
  208. There are 3 entries above...
  209.  
  210. DORINFO1.DEF is a standard exit control file produced by QuickBBS and other
  211. popular BBS systems, containing the current users information.  As your BBS
  212. system exits to operate an external program like RAD, it writes this little
  213. file to allow the external program to read it and have the current transfer
  214. information.  Take a look at the file description that follows for the type of
  215. information it contains.  If you describe dorinfo1.def complete with drive spec
  216. and path, it will be used to decide whether the user can support ANSI/Color, how
  217. much time he/she has left online, current access level, etc...
  218.  
  219. If you do not have a parent system that creates DORINFO1.DEF, let us know and
  220. we'll try to accommodate.  Most BBS systems produce exit control files of one
  221. type or another, and there are many little conversion programs available on
  222. BBS's that will convert from one to another.  In that case you would have to run
  223. RADPLUS from a batch file.  For example
  224.  
  225. Sample batch for systems that don't produce dorinfo1.def
  226.  
  227. WINGWANG     ... THE BBS SYSTEM
  228. CONVERT      ... THE CONVERTER (changes wingwang.xit to dorinfo1.def)
  229. RADPLUS      ... RADPLUS
  230.  
  231. Sample dorinfo1.def...
  232.  
  233. The Lighthouse BBS      ;Systems name
  234. HARVEY                  ;SysOps first name
  235. PARISIEN                ;SysOps last name
  236. COM1                    ;Current port
  237.  
  238.                                                                           Page 3
  239.                                                RAD Plus - Remote Access Database
  240.  
  241. 2400 BAUD,N,8,1         ;Current connection information
  242. 0
  243. JOHN                    ;User's first name
  244. SMITH                   ;User's last name
  245. KINGSTON, ON            ;User's address
  246. 1                       ;ANSI on/off flag
  247. 20                      ;User's SECURITY LEVEL
  248. 59                      ;User's MAX TIME ALLOWED (balance of time from recent
  249.                                                   BBS activities)
  250.  
  251. The next fields MIN_TIME and MAX_TIME are online time limits, and are in
  252. minutes.  If you enter information here, it overrides dorinfo1.def (can be used
  253. for systems that don't produce proper dorinfo1.def's to limit access time).  IE,
  254. if your user has 90 minutes left online and your MAX_TIME is set to 10, then
  255. he/she will have 10 minutes in RAD only.  It is recommended that you set
  256. MIN_TIME to 0 if it is your intention to NOT allow further access once a users
  257. time has run out.
  258.  
  259. Your COM_PORT must be described as COM1, COM2, COM3, or COM4.
  260.  
  261. Your MAX_BAUD can range from 300 baud to 115200 baud.
  262.  
  263. The USE_SCREEN field is a logical setting of T or F (true or false).  If you set
  264. this to F then the screen will remain BLANK during RAD operations.  This may be
  265. desirable for multitasking situations.  Normally this would be T.  It is
  266. possible for the SysOp while the user is online to turn the screen ON or OFF by
  267. pressing F2 (snoop) on the HOST system.  It is also possible for a user with the
  268. maximum level 4 setting to turn the screen on or off remotely.
  269.  
  270.                                    RADDIR.CFG
  271.  
  272.  
  273. Record:  1  of  8
  274.  
  275. FILE       :RADCFG.DBF  :
  276. SUBJECT    :RAD Main Configuration File             :
  277. DISPLAY_ON :T:
  278. USER_NOTES :SYSOP                                             :
  279. DISPLAY1   :Keep this file marked private                          :
  280. DISPLAY2   :                                                       :
  281. DISPLAY3   :This file contains your setup and default information. :
  282. DISPLAY4   :                                                       :
  283. DISPLAY5   :Use DB3ED (DB.EXE) or RAD to edit this file.           :
  284. DISPLAY6   :                                                       :
  285. DISPLAY7   :NOTE:  Leave the field DOOR_PATH blank if you will be  :
  286. DISPLAY8   :       using RAD offline only!                         :
  287. PASSWORD   :YOURPASSWORD    :
  288. MIN_LEVEL  :4:
  289.  
  290. This database file contains the FILE name and SUBJECT line for each file that is
  291. to be displayed by a DIR command online.  If a *.dbf file exists and is not
  292. recorded in the RADDIR file, it will show up in a DIR, but will have a ? for
  293. subject line and have no password or minimum level access requirement.  The
  294. third field DISPLAY_ON can be set to T or F.  It determines whether the Display1
  295. through to Display8 fields are displayed when the file is accessed with a DIR
  296. command.  Display1 to Display8 are not displayed when the file is accessed using
  297.  
  298.                                                                           Page 4
  299.                                                RAD Plus - Remote Access Database
  300.  
  301. a USE command.  See the next few screens which simulate the DIR and file
  302. selection screens.  USER_NOTES can be anything you like.  The person who lists
  303. the file usually puts his/her John/Martha Henry here.  PASSWORD is your 16
  304. character password required for this file.  You don't need a password for the
  305. MIN_LEVEL system to work.  The MIN_LEVEL is an absolute minimum access level
  306. required to even have the ability to enter a password.  The TWO levels of
  307. security for each database file should cover most situations.  MAKE SURE YOUR
  308. RADCFG.DBF AND RADDIR.DBF FILES ARE BOTH PASSWORDED AND SET TO 4 AS THE
  309. MIN_LEVEL.  If you do not want to allow online editing of these two files by a
  310. remote SysOp who has level4 access, then set the MIN_LEVEL to 5 so they can't be
  311. accessed at all.
  312.  
  313. Here is a DIR simulation from the dot prompt...
  314.  
  315. .dir
  316.  
  317. RAD v2.09 - Remote Access Database - Copyright (C) 1990 Overerx Inc.
  318.  
  319.   # Filename      Records  Updated   Subject
  320.   1 BBSLIST.DBF      1280  11/04/90  A list of BBS's with >= 100megs online
  321.   2 DB.DBF              3  11/04/90  A list of contacts for local services...
  322.   3 IDEAS.DBF           1  11/04/90  Ideas for RAD databases ...
  323.   4 SUPPORT.DBF        68  11/04/90  Computer related product support lines
  324.  
  325.   Enter # _
  326.  
  327. NOTE: RADCFG.DBF and RADDIR.DBF will not be displayed in a Directory.
  328.  
  329. When you enter RAD, you are presented with a pretty nifty title page (free ad
  330. for me), and then displayed your current stats like the following session
  331. simulation.
  332.  
  333.  
  334. RAD v2.09 - Remote Access Database - Copyright (C) 1990 Overerx Inc.
  335.  
  336. 11/05/90  9:48a
  337.  
  338. Registered to.......... The Lighthouse BBS
  339. System Operator........ Harvey Parisien
  340. User................... HARVEY PARISIEN
  341. User level............  4
  342. Balance online time...  19 minutes
  343.  
  344. Hello HARVEY ...
  345.  
  346. CHOICE: Help Dir Find Browse N]ext Prev Goto List Info Add Edit Cmd Quit _
  347.  
  348.  
  349. Rad starts up in MENU mode.  If the user has ansi.sys installed, they will be
  350. displayed a lotus like menu bar which has a description of each function in the
  351. menu bar itself.  For non ansi users, the basic menu bar shown above is used.
  352. Alternatively, you can choose command mode, which gives you a DOT prompt like
  353. dBASE.  In command mode you have the following commands, which can be displayed
  354. anytime by entering the command HELP.
  355.  
  356.  
  357.  
  358.                                                                           Page 5
  359.                                                RAD Plus - Remote Access Database
  360.  
  361. .HELP
  362.  
  363. Command:         Function:                                            Level:
  364. /                Invoke command MENU option.                               1
  365. HELP             (or ?) Display this screen                                1
  366. INFO             Display system and user information                       1
  367. CLS              Clears Screen and Resets FIND search to ALL               1
  368. DIR              Displays directory of *.DBF files                         1
  369. USE filename.dbf USE or LOAD database (.dbf not required)                  1
  370. LIST STRUCTURE   List the file structure for the current database          1
  371. FIND text        FIND and display record matching text                     1
  372. BROWSE text      FIND and list records (max fields that fit on one line)   1
  373. NEXT             FIND and display NEXT record (or just press ENTER)        1
  374. PREV             More to previous record                                   1
  375. GOTO n           where n is the record number (also GOTO FIRST or LAST)    1
  376. COUNT            FIND and COUNT occurrences of FIND                        1
  377. SUM fieldnumber  Add contents of a field and display total                 1
  378. ADD              ADD (or append) a new record                              2
  379. EDIT n           n is an optional record number (default = current record) 2
  380. DELETE n         n is an optional record number (default = current record) 2
  381. CREATE           Closes current file, and prompts for creation details     3
  382. PACK             Pack current database (removes deleted files)             3
  383. SORT fieldnumber SORT database on a field (will prompt for fieldnumber)    3
  384. QUIT             Exit program (closes all files)                           1
  385. .
  386.  
  387.  
  388. The online commands will be very intuitive to dBASE users and non dBASE users
  389. alike.  The screens and prompts should provide adequate information for the
  390. typical user online.
  391.  
  392.  
  393.                                  SYSOP FUNCTIONS
  394.  
  395. USER: Joe Blow                PARAM: COM1:2400,N,8,1,RB1024,XON       LEVEL:  3
  396. 1 CHAT |2 SNOOP|3      |4      |5      |6 JUMP |7      |8      |9 LEVEL|10 HANG
  397.  
  398. The last two lines on your HOST screen remain in position at all times.  They
  399. constantly display the Users name, and current communications data.  It shows
  400. the users level which can be toggled with F9.  OK, let's continue from right to
  401. left just to be different.  F10 causes an immediate hang up to which the user is
  402. given no indication or warning as to what happened.  F6 allows the host to jump
  403. to DOS.  F2 allows the HOST to toggle the HOST screen on/off.  F1 allows the
  404. host to enter into CHAT mode, where both host and user can chat to each other
  405. with their keyboards.  By the way, when a users time online gets to be 2 minutes
  406. or less, he/she is given a warning to that effect (even if in chat mode).  They
  407. can always enter INFO to see their current status.
  408.  
  409.  
  410.          Operating RAD Plus from the command line, or a parent program.
  411.  
  412. RADPLUS /Pdrive:fullpath
  413.  
  414. IE: from a DOS prompt...   D:\>c:\dbase\radplus /Pc:\dbase
  415.  
  416. drive:path is where RADPLUS.EXE RADDIR.DBF RADCFG.DIR AND *.DBF files are kept.
  417.  
  418.                                                                           Page 6
  419.                                                RAD Plus - Remote Access Database
  420.  
  421.  
  422. If no path is given the current directory is assumed.
  423.  
  424. IE: QuickBBS type 7 command line:  c:\rad\radplus.exe /Pc:\rad
  425.  
  426. IE: Maximus control lines for menus.ctl ...
  427.   NoDsp Display_File    misc\dorinfo                        Privil "Radplus"
  428.           Xtern_Run     C:\max\rad\radplus.exe_/pC:\max\rad Privil "Radplus"
  429.  
  430. It is important that if /P is used, that the path is complete with drive spec
  431. as in these examples.
  432.  
  433. If you are operating RAD locally (ie from your BBS in local mode) it will
  434. sense there is no carrier so it requires you to press L to enter locally or
  435. it exits back to the board automatically.  RAD has a built in carrier detect
  436. system.  If carrier is dropped while a user is in RAD (or on their way to rad),
  437. it gracefully exits back to your board and let's your board do it's own thing.
  438.  
  439.  
  440.  
  441.                                   MISC FEATURES
  442.  
  443. LOCK_EDIT
  444.  
  445. If the first field name in a database is called LOCK_EDIT, then the record will
  446. will automatically be restricted in terms of a users ability to edit it.  When a
  447. record is added, the current users name is automatically inserted into the
  448. LOCK_EDIT field.  This field can not be changed (except by the SysOp Level4).
  449. To Edit the record, you must be the user, or have level4 access.
  450.  
  451. AUTOEXEC.RAD
  452.  
  453. If a file called Autoexec.RAD exists in the Rad directory, RAD will look in tha
  454. file on the first line for a filename.  If it's a legal name IE: XXXXXXXX.DBF it
  455. will automatically be loaded.
  456.  
  457. Locked baud rates are supported now, just put an L as the last character of your
  458. MAX_BAUD field in radcfg.dbf.
  459.  
  460. Multiuser nodes can use RADPLUS now without using separate directories.  While a
  461. database is in use, it is stamped as ????????.BSY (like the system used by
  462. BinkleyTerm).
  463.  
  464. RADPLUS.SCR
  465.  
  466. If a file called RADPLUS.SCR exists in the Rad directory, RAD will display
  467. that file as a start up screen as opposed to the default RAD logo.
  468.  
  469.  
  470.  
  471. This program is shareware.  It may be used for a 20 day trial period, and then
  472. must be registered.
  473.  
  474.  
  475.  
  476.  
  477.                                                                           Page 7
  478.                                                RAD Plus - Remote Access Database
  479.  
  480.                          Distribution, and Registration
  481.  
  482.  
  483.          RAD is marketed as shareware.  It may be used for a 20 day
  484.          trial period, and then must be registered.
  485.  
  486.          RAD is fully functional.  There are no timers, or limits
  487.          imposed.  There are no keys required for installation.  Your
  488.          honesty is our only protection against insufficient
  489.          development funds, and we have learned to trust in that.
  490.  
  491.          To register, please fill out the REGISTER.TXT application.
  492.          You can load it into your word processor or editor, and edit
  493.          it, or copy it to your printer and do it by hand (COPY
  494.          REGISTER.TXT PRN).
  495.  
  496.                                 Harvey Parisien
  497.                                Box 323 Station A
  498.                                Kingston, Ontario
  499.                                  Canada K7M 6R2
  500.  
  501.          Registering RAD is only necessary once, and entitles you
  502.          to new versions of RAD as they are released.  The latest
  503.          versions of RAD will be available on your favorite SDS
  504.          system, or directly from FidoNet 1:249/114.
  505.  
  506.  
  507.                              Registration is $75.00.
  508.  
  509.           Non Commercial BBS SysOps may register RAD Plus for $ 25.00.
  510.  
  511.  
  512.  
  513.                                                                           Page 8
  514.                                                RAD Plus - Remote Access Database
  515.  
  516.  
  517.  
  518.                                   LEGAL STUFF
  519.  
  520.          DISCLAIMER - This program is provided as is.  You may use it
  521.          at your own risk.  There is no warranty of any kind or any
  522.          form covering this program.  The author may in no way be held
  523.          liable for any damage of any form in connection or arising
  524.          from the quality and/or use of this program and any
  525.          associated files included with it.
  526.  
  527.          Registered users feel free to contact me via NETMAIL, or by
  528.          calling my BBS for instant support...
  529.  
  530.                        Harvey Parisien, FidoNet 1:249/114
  531.                                 613-389-3992 BBS
  532.  
  533.  
  534.                 ** YOUR FEEDBACK, AND SUPPORT IS APPRECIATED **
  535.  
  536.  
  537.                                                                           Page 9